Разбиение текста на части, главы, заголовки и абзацы.

Для удобства восприятия и ориентирования, текст иерархично разбивается на фрагменты: части, главы, текстовые заголовки различного уровня и абзацы.

В маркван-разметке такие блоки текста маркируются тройным повторением соответствующих символов в строке перед названием такой части.

Название произведения

Каждый документ обычно имеет название. Оно может быть только одно и выделяется тремя символами * (звёздочка).

***
Название произведения

Части и главы

Большие произведения могут разбиваться на части(разделы), а части, в свою очередь, на главы. Название части обозначаются символом ^ (карет), а главы символом " (двойные кавычки).

^^^
Название части

"""
Название главы

Части или главы не обязательно использовать в вашем произведении, если оно небольшое, то сразу можно применить текстовые заголовки.

Текстовые заголовки

Для структурирования повествования применяют текстовые заголовки (text header) начиная с первого уровня.

===
Заголовок первого уровня

---
Заголовок второго уровня (подзаголовок)

...
Заголовок третьего уровня

,,,
Заголовок четвертого уровня

:::
Заголовок пятого уровня

;;;
Заголовок шестого уровня

Заголовок-разделитель или пауза

Использование пустого заголовка подразумевает некую иерархичность деления текста на куски. Если мы просто хотим разделить повествование в её однородном течении, но абзаца нам недостаточно, то используется заголовок-пауза, которая обозначается тремя символами ~ (тильда).

Некое повествование

~~~

Продолжение повествования

Отступы заголовков

После Названия, Части, Главы и текстовых заголовков обязательно вставляется пустая строка. Для удобства восприятия, перед ними также оставляются пустые строки:

• Части предваряют 4 пустые строки;
• Главы - 3 строки;
• Заголовок первого уровня - 2 строки;
• Остальные заголовки - 1 строка.

Двойные заголовки

Можно проставлять номера или буквы прямо в название, но в книгопечатании есть такой приём, когда идентификатор заголовка и сам заголовок располагаются в разных строках.

В маркване это тоже можно сделать для частей, глав и заголовков первого уровня. В этом случае идентификатор и название пишутся последовательно без разделения пустой строкой.

^^^
Часть I
Общая теория всего

Для нумерования заголовков первого уровня часто используется термин параграф и обозначается знаком § (параграф).

===
§5
Простые числа

Идентификаторы заголовков

Идентификаторы заголовков это служебная информация, она не будет видна пользователю при конвертации. Идентификатор позволяет сослаться на этот заголовок из другого места.

Идентификатор указывается после обозначения заголовка. Признаком идентификатора является знак # (решётка). Может состоять из прописных букв a-z, цифр 0-9, разделителей - (минус) и _ (подчеркивание).

=== #р146
График параболы

Разделительные линии

Сплошное нижнее подчеркивание _ не является заголовком, а создает разделительную линию. Не стоит злоупотреблять подчеркиванием. Можно использовать линию, например, для отделения не относящейся к произведению информации.

___

Разрывы текста

По правилам русского языка многоточие для пропуска части текста можно использовать многоточие в угловых скобках ‹…›. Эти символы не следует заменять на знаки больше-меньше и точки.

Абзацы

Абзац это фрагмент текста, начинающийся с новой строки. Позволяет разделить отдельные мысли в однородном повествовании и служит для комфорта навигации взгляда читателя.

В маркван-разметке текст делится на абзацы просто переносом строки. Пустая строка не добавляется. Отступы абзацев (красная строка) не добавляются.

Старый заголовок
================